home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / uti240e.zip / UTI240E.TXT next >
Text File  |  1992-10-26  |  5KB  |  121 lines
  1.                         WildCat Enhanced UTIs
  2.                                v2.40e
  3.  
  4.  
  5. 1.  Thanks to Chuck Mattern.  A corrupted message file was causing
  6.     the UTIs to lock up.  In this case, the message size did not
  7.     match the message record, causing a lock/loop as the UTIs
  8.     searched for a valid end-of-message mark.  Fixed.
  9.  
  10.                         WildCat Enhanced UTIs
  11.                                v2.40d
  12.  
  13. 1)  I've been seeing a lot more bad command lines coming from PL.
  14.     Originally, if there were not enough parameters the UTIs
  15.     would display a message to the screen, but not log the error.
  16.     This was a convenient way to find out a program's version number,
  17.     or to see the command line structure.
  18.  
  19.     Starting with this version, all failed attempts to run the UTIs
  20.     will be logged to the UTI.LOG file.  Hopefully we can cut down
  21.     on mysterious errors that don't get logged.
  22.  
  23. 2)  The Extend Handles routine has been dropped.  I have a semi-
  24.     commitement from Kip that there will always be at least 13
  25.     file handles available to the UTIs.  The programs were modified
  26.     in 2.40ß to use fewer handles, so this should not be a problem.
  27.  
  28. 3)  If a Subject, From, or To line is blank, the UTIs will insert the
  29.     word 'BLANK' in that message field.  It is better to have a message
  30.     from 'BLANK' than to have possible problems crop up.
  31.  
  32. 4)  UTIEXPRT speed increased by 50-70%.  Since PostLink scans all
  33.     imported messages for possible exports, the UTIs are able to speed
  34.     up the scanning process by retrieving only the first part of
  35.     each message.  Once a valid export is detected, the UTIs switch
  36.     to full message reads.
  37.  
  38.                         WildCat Enhanced UTIs
  39.                                v2.40c
  40.  
  41. 1)  Added support for the MAXLINES environment variable.  If this
  42.     DOS variable is set, it will override the maximum message line
  43.     setting in MakeWild.  This variable affects all conferences
  44.     and works on import only (of course).
  45.  
  46.         Example:  SET MAXLINES=100
  47.  
  48.     Let's say a particular conference only allows 40 lines.  You
  49.     set MakeWild to 40 lines so your callers can't leave longer
  50.     messages, but you don't want network messages split on import.
  51.     Using this variable gives you flexibility.  It is optional.
  52.  
  53.  
  54. ---------------------------------------------------------------------
  55.            WildCat Enhanced UTIs -- Beta Version for 2.40b
  56.  
  57.  
  58. PostLink Error Messages
  59. -----------------------
  60.  
  61. PostLink only reports the low-order byte of any of the UTI runtime
  62. error messages.  For example, a 9901 error would be reported by
  63. PostLink as 173:      (38 * 256) + 173 = 9901.
  64.  
  65.   10070 would be 86:  (39 * 256) +  86 = 10070
  66.  
  67. DOS, I/O, and Runtime error codes are defined as integers/words
  68. in Turbo Pascal and C++, but PostLink does not report the whole
  69. error code.  If you receive a strange error, try checking the
  70. UTI.LOG file for the real error message.
  71.  
  72.  
  73. Memory Gobbling
  74. ---------------
  75.  
  76. If PostLink (up to at least 1.02) is run with swapping disabled,
  77. it will shell to the UTIs with less and less memory each time.
  78. It looks like memory is being allocated to process messages, but
  79. is not de-allocated.  I pared down the memory requirements of
  80. UTIIMPRT and UTIEXPRT in version 2.3 and haven't had any
  81. further reports of memory errors.
  82.  
  83. Something to check if you see strange errors...
  84.  
  85.  
  86. File Handle Gobbling
  87. --------------------
  88.  
  89. First, some background on file handles:  No matter how high you set
  90. your FILES= to in your config.sys file, each process is only allowed
  91. to open 20 files at a time.  5 of these files are reserved for
  92. standard I/O processes, so each program is limited to having 15 files
  93. open at a time.
  94.  
  95. When PostLink first shells to UTIEXPRT or UTIIMPRT, 15 file handles are
  96. available for use -- unless you swap to disk, in which case 14 handles
  97. are available.
  98.  
  99. HOWEVER, once messages are imported or exported, PostLink uses some
  100. file handles and does not release them.  In my testing, I have seen
  101. as few as 8 file handles available to the UTIs.  This was causing a
  102. error when UTIIMPRT tried to open the ALLUSERS file after the LOG file
  103. was already open.  (For multi-line WC boards, ALLUSERS requires 3 file
  104. handles, for single-line, 2 handles.)
  105.  
  106. Solutions:
  107.  
  108. 1)  The log file is now closed immediately after use.  This may mean
  109.     that the log file will be opened/closed repeatedly during
  110.     processing.  It is slower but safer.
  111.  
  112. 2)  Before opening the ALLUSERS file, UTIIMPRT will close the MSGxxx
  113.     database file.  After ALLUSERS is finished, MSGxxx will be
  114.     reopened.
  115.  
  116. 3)  For those running DOS 3.3 or above, UTIIMPRT and UTIEXPRT now
  117.     extend the number of file handles available to it to 40.  Even
  118.     if PostLink shells with only 2 file handles, the UTIs will
  119.     continue to run.
  120.  
  121.